VS Archive Converter 0.9 — recovers the recordings from Roland VS-1680 backup CDs
(Requires macOS 14 Sonoma or newer; Apple Silicon or Intel Mac)
Full instructions: "VS Archive Converter - User Manual.pdf" (in this folder).

FIRST TIME — DO THESE STEPS ONCE, IN THIS ORDER
Golden rule: a permission only works after you QUIT the app with ⌘Q and open it
again. If something says "not permitted", quit (⌘Q) and reopen before anything else.

1. Move the app FIRST. Drag "VS Archive Converter.app" into your Applications
   folder BEFORE opening it. Don't run it from Downloads or from this folder:
   macOS isolates apps started there and the permissions don't stick.
2. Open it once (double-click in Applications). macOS says it can't verify the
   developer — click "Done" / "OK".
3. Right away, open System Settings › Privacy & Security, scroll to the bottom and
   click "Open Anyway" next to "VS Archive Converter". Enter your password and
   click "Open". (The button only shows for a while after a blocked attempt —
   if it isn't there, repeat step 2. Older macOS: right-click the app › Open.)
4. Full Disk Access (needed to read CDs): System Settings › Privacy & Security ›
   Full Disk Access › click + › choose "VS Archive Converter" in Applications ›
   turn the switch ON.
5. QUIT the app with ⌘Q (closing the window is not enough) and open it again.
6. When macOS asks for access to a folder or external drive, click "Allow".
   (Clicked "Don't Allow"? Turn it on in Privacy & Security › Files and Folders,
   then quit and reopen.)

AFTER INSTALLING A NEW VERSION: repeat steps 3-5. In Full Disk Access, remove the
old entry with "−" and add the new app with "+".

READING A VS CD DIRECTLY
- Needs Full Disk Access (steps 4-5 above). Without it macOS blocks the CD with
  "Operation not permitted" even after you type your password.
- Connect a USB CD drive and insert the VS backup CD.
- macOS will say the disc is not readable: click "Ignore" (not "Eject").
- In the app, click "Read CD…", choose a name and a folder for the image,
  and enter your Mac password when asked (macOS only allows reading the raw
  CD that way). The image opens in the app when it's done.
- The last sector of a VS CD-R is often unreadable: that is normal and holds no audio.
- Backups that span several CDs: read every disc; the app joins them by itself.

OTHER WAYS IN
- It also opens IsoBuster images (CD.ibq + CD.ibp, or .iso) — drag them into the window.

EXPORTING
- Click "Export…" (⌘E) and pick a format:
  • WAV files — one per V-Track, in folders by group. Each WAV carries its
    original position (BWF time stamp) and the song tempo (ACID chunk).
  • AAF (Logic / Pro Tools) — recommended for Pro Tools and Logic.
    Pro Tools: File › Open Session, choose the .aaf.
    Logic: File › Import › AAF.
    "Put the audio inside the AAF" (on by default) makes one self-contained
    file; turn it off to keep the WAVs in an "Audio Files" folder instead.
    Stereo pairs arrive as two mono tracks (L/R) — Pro Tools requires that.
  • Logic Pro (Final Cut Pro XML) — alternative for Logic.
  • Ableton Live session.
  • DAWproject — for Cubase / Studio One / Bitwig.
- "Include tempo map MIDI" adds a small .mid file with the song's BPM and time
  signature. Drag it into your DAW to set the tempo (AAF and XML don't carry it).
- Each export goes into one folder, "Song - BPM (Format)", with a
  "VS-1680 Info" folder holding a report (Relatorio.txt) and info.json.

TIP (Pro Tools): if a session seems not to open, check other Desktops
(Mission Control, ⌃↑) — Pro Tools may have opened its windows there.
